home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 051-075 / scopedisk72 / tag-25 / tag.doc < prev    next >
Text File  |  1995-03-19  |  46KB  |  1,057 lines
  1.  
  2.                           T.A.G. BBS
  3.                       Originally released as TAG 1.3
  4.                       by Patrick E. Huges
  5.                           -----------------
  6.                        Released as TAG 2.01
  7.                           by Chuck Maier
  8.  
  9.           |---------------------------------------------------------|
  10.           | UPGRADE INFORMATION IS FOUND AT THE BOTTOM OF THIS TEXT |
  11.           |---------------------------------------------------------|
  12.  
  13.  
  14. *note: Lines in this manual starting with '*' are updates from Chuck
  15.        Maier and define changes and his notes!!
  16.  
  17.  
  18.          TAG-BBS is an online message and file handling system written
  19.     by Patrick E. Hughes specially  for  the  Amiga personal computer.
  20.     This manual  describes  the  installation  and  operation  of  the
  21.     software.
  22.  
  23. *   The TAG system source that was released was full of holes and
  24. *   just plain errors. It would not compile! I am using the Lattice
  25. *   4.0 system but the errors had nothing to do with my choice of
  26. *   compilers except for the 'scanf' function. For that reason, I've
  27. *   spent several MONTHS and countless hours straightening out the
  28. *   code, adding feature after feature and generally making it into a
  29. *   BBS you, as a potential sysop, could be proud of!
  30.  
  31.          Speaking  generically,  a  Bulletin  Board  System  (BBS)  is
  32.     nothing more than a program  that  organizes  a series of notes to
  33.     make them easier to read.  Specifically,  TAG-BBS is this and much
  34.     much more. Not only are messages  neatly  organized and maintained
  35.     by TAG-BBS,  but people may send private mail and access files for
  36.     transfer and reading.  In  addition,  each  of  these abilities is
  37.     protected with a flexible security.
  38.  
  39.  
  40. *        I have no visions of fortune! But I will guarentee updates
  41. *   for as long as there is interest in this program and I am capapable!
  42. *   All you need do is give my BBS a call... and download the updates.
  43.  
  44. *
  45. *                  Chuck Maier
  46. *                  C.A.B. of Delaware 302-764-3186
  47. *                  Wilmington, De
  48. *
  49. *    If you like the 2.xx ... Say nice things and send good thoughts and
  50. *    keep your money if it means THAT much to you! Amiga and its powers
  51. *    keep me interrested and I look forward to keeping the BBS and Amiga
  52. *    together and progressive!
  53. *
  54. *    The BBS number above can be reached to gain access to the continuing
  55. *    upgrades from my desk! The BBS route may be long distance but
  56. *    new revs are sure to be forthcomming... why spend a dollar to save a
  57. *    quarter!!???
  58.  
  59. *        At present, the code is VERY WORDY!! You may not understand this
  60. *    phrase... but I have NOT tried to cut down the SIZE of the T.A.G.
  61. *    system and its memory hungry structures... although I have mastered
  62. *    them. It is apparent that I will, in future updates, be able to
  63. *    cut 30% of the executable size with not too much trouble! All I have
  64. *    been concentrating on  has been packing T.A.G. with features!!
  65.  
  66.  
  67.  
  68.     o    Messages  may be separated  into  an  unlimited  number  of 
  69.          bases, or "sub-boards" as they are usually called. Each has 
  70.          it's own  security,  and each  may be  of a different size.
  71.  
  72.     o    Files are much  the same as messages, the only limitation 
  73.          being  the amount  of disk  space  available. You may use 
  74.          as many subdirectories as you want, and each has it's own 
  75.          security.  At present Xmodem-Checksum and  Xmodem-CRC are 
  76.          supported  protocols,  and  the  software  automatically 
  77.          responds to the caller's settings.
  78.      
  79.     o    Security is flexible and based on the individual account 
  80.          rather than the entire system. 
  81.      
  82.     o    Automatic support for all modems via their result codes. 
  83.          All serial I/O routines have been optimised and are 
  84.          fully buffered for top speed, this includes protocol 
  85.          transfers too, where the increases really show.
  86.      
  87.     o    Sysop is given as much power as is practical. Increase and 
  88.          decrease time limits instantly, edit accounts quickly online,
  89.          force instant logoff, control of I/O streams (serial in/out, 
  90.          screen & keyboard on/off), send all output to printer 
  91.          and disk file (singly or simultaneously).
  92.      
  93.     o    TAG-BBS was designed with two criterion in mind, speed 
  94.          and reliability. Using efficient programming techniques has 
  95.          resulted in both a system unburdened by unrealistic limits 
  96.          and one ideally suited for a multi-tasking system. The 
  97.          software was written and tested fully on an Amiga system, 
  98.          and verified on a fully expanded hardware setup, not ported
  99.          from some other brand of computer..
  100.      
  101.     o    Multi-tasking is not hampered! You can do whatever you 
  102.          like since TAG runs as a separate process by design, and 
  103.          follows all programming guidelines; assuming memory is 
  104.          available for the other tasks, naturally.
  105.      
  106. *   o    A complete statistics package is included for keeping
  107. *        track of the users, uploads(with optional time compensation),
  108. *        downloads, and per-call statistics.
  109. *        Also included is a simple automatic sysop validation package
  110. *        to allow library validation... hands off if you wish.
  111. *
  112. *   o    A TRIVIAL pursuit database has been moulded right into the BBS
  113. *        since it seemed a VERY simple but enjoyable means of BBS-user
  114. *        gaming. A stats package is included for this along with a
  115. *        HALL-OF-FAME feature!! My co-SYSOP (Dennis Budzitowski) is
  116. *        responsible for the present content of my trivia database!
  117.      
  118.                           Hardware Requirements 
  119.      
  120.     Amiga Personal Computer: 
  121.          1 MEG RAM (more recommended)
  122.          2 disk drives (hard drive heavily recommended)
  123.          Modem (must support DTR pin, almost all do..)
  124.                (can use from keyboard alone for testing)
  125.  
  126.                             Hardware Supported 
  127.      
  128.     All extra memory improves performance and sizes allowed
  129.     All AmigaDOS compatible hard drives of any capacity 
  130.     All printers. Used for online "hard copy"
  131.  
  132.  
  133.  
  134.                          Configuring Your System 
  135.  
  136. *      An icon is included with the data necessary to fire-up the BBS
  137. *      once the files are in order (see below). This is NOT a simple
  138. *      icon but it is an EXICON program in itself! Please be sure to
  139. *      edit the associated files as I have included MY actual file
  140. *      contents and many of them will not EXACTLY work on yours!!!
  141. *         Note... The stack should be set to 20000 or you will be
  142. *      visited from the GURU!!
  143.  
  144.          Defining your system  means  filling  in  a set of text files 
  145.     with the required information, nothing  more nothing less. You can 
  146.     use any standard text editor for this purpose: Ed, MicroEmacs, vi; 
  147.     all  come  to  mind.  The  files  involved  in  this  are  called: 
  148.     Tag_System, Tag_Boards, Tag_Bulletins,  and Tag_Libraries.
  149.      
  150.      
  151.          Tag_System 
  152.     Contains all the pertinent  information  on the system itself, the 
  153.     default securities for  accounts,  modem  control strings, and the 
  154. *   mail and trivia definition.
  155. *   This also includes a parameter for EXPRESS mail! The Express mail
  156. *   parameter is to allow a user to cause the actual mail to pop in
  157. *   the addressees eyes when the addressee signs on!
  158.     
  159.          Tag_Boards 
  160.     Location, size, and security of the message bases on your system. 
  161.      
  162.          Tag_Bulletins 
  163.     Each bulletin is a text file, which  can be read by anyone who has 
  164.     the appropriate security.  Each  may  be  located anywhere, on any 
  165.     disk as long as it is described here. 
  166.      
  167.          Tag_Libraries 
  168.     As with  the  message  bases,  each  library  defines  a  separate 
  169.     subdirectory. Other than that,  your  only worry is  what security 
  170.     each section deserves to worry about.
  171.  
  172. *        *=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*
  173. *
  174. *             an ODD number of sublibs is NICE!!!!
  175.  
  176. *   SubLibs were added to furthur differentiate the mass of files that
  177. *   you get as a BBS. There is NO limit to the number of SubLibs but
  178. *   the number must be ODD! Provision in the Tag_Libraries allows
  179. *   you to name as many as you wish. These are named in the Tag_Libraries
  180. *   file PRECEEDED with a V: which is preceeded with an OPTIONAL number.
  181. *   This number is ONLY to help count the number of entries as the
  182. *   file parsting routine looks for 'V:' to find a sub-dir name!
  183. *   UploadcCompensation was also added. There are an unlimited number of
  184. *   settings for this variable. If you don't want to give back time to the
  185. *   user the time he spent uploading... put (-1) in the variable.
  186. *   Any positive setting will give back upload time and optionally
  187. *   a premium based on the formula... [n=parameter]
  188. *   (#K of upload * n) + (upload time)
  189. *   Therefore... if you set it to .22 and the user uploaded a 30K file
  190. *   which took 6 minutes... he would get 13 minutes credited to his
  191. *   allowable online time. (6 mins upload + 6.6mins Premium).
  192. *   If the upload goes bad (because of line problems etc...) he ONLY gets
  193. *   his upload time back.
  194. *   To ONLY give back upload time... put ZERO in the variable!
  195.  
  196.      
  197.                               A WALK-THROUGH 
  198.      
  199.          First you should go through the TAG_xxx  files and using their
  200.     guidelines, change them to define  your system configuration. I
  201.     leave the details of this step up to you!
  202.      
  203.          After you finish filling out  the  Tag_xxxx  files, copy them 
  204.     into the S: directory of your WorkBench disk. AmigaDOS uses the S: 
  205.     directory for its startup  files,  and  so does TAG-BBS. I do this 
  206.     for two reasons: one being that  no  matter what directory TAG-BBS 
  207.     is run from it can always  find  its  configuration,  the   second 
  208.     being that TAG-BBS can be run  from  anywhere, there is no need to 
  209.     change directories or have a 'root directory' to deal with.
  210.     All sections must be in a SEPARATE directory.
  211.      
  212.          Next  you  must  create   all   the   directories  that  your 
  213.     configuration requires. The only thing to worry about here is that 
  214.     you get all the names spelled  correctly, and  that  each  section
  215.     must be in a SEPARATE directory.
  216.      
  217.          The next to last step in  the  walk-through,  making  all the 
  218.     data files required. Run  the  Generate  utility  and  watch it go 
  219.     through its gyrations. If there will  be any problems running what 
  220.     you wrote into the configuration files Generate will abort and let 
  221.     you know where it couldn't  continue.  Using this information will 
  222.     allow you to rewrite your  configuration  and  try again.
  223.        If there are any errors that you can't figure out pay close
  224.     attention to the amount of disk space left. TAG-BBS  creates all the
  225.     data files needed in their full size. You can never run out of disk
  226.     space (file libraries notwithstanding)  with  TAG-BBS, and Generate will
  227.     not let you use a configuration  too  large for the amount of disk 
  228.     storage available. 
  229.      
  230.          At last, the final step! After all  is written and data files 
  231.     generated CLICK on the ICON!!. You'll  see  the windows open, and you'll
  232.     see it waiting for a caller. By typing in "A" followed by [return] 
  233.     you activate the  account  editor.  Edit  account #1, which is the 
  234.     Sysop by default, and set all  information.  You'll need to make a 
  235.     name, password, and change all security levels to 255. Don't forget
  236.     to validate yourself as sysop!
  237.  
  238. *   Please note... In the Tag_system file is a USERS parameter. You can
  239. *   feel free to pick a really LARGE number to enter here as long as
  240. *   you have enough DISK space. All the other units.. Libraries,
  241. *   Bulletins etc are kept in RAM and therefore take up RAM!
  242.  
  243.          Voila, vous etes finis.
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.                             SECURITY NUMBERS
  251.  
  252.  
  253.         Security is separate for each major section of TAG-BBS, Messages
  254.     Libraries, Bulletins, and Status. I'll discuss each of these in turn
  255.     to make matters clear.
  256.  
  257.         Sec_Status:
  258.     This is the major security you need to know. There are several
  259.     default values, all of which mean very special things.
  260.  
  261.     =    0 Guest. A first time caller, 0 is the suggested value.
  262.  
  263.     =    1 New. Just after Joining the board, 1 is suggested.
  264.  
  265.     =    2 Valid. Set when you edit accounts and Validate.
  266.  
  267.                The above are set from your Tag_System file, and
  268.                represent standard values as defined in the system.
  269.                It is entirely possible for you to give New
  270.                accounts full powers and give everyone
  271.                Sysop status immediately..
  272.  
  273.     >= 100 BoardOp. Can do the message base functions D>elete,
  274.            +>Lock, and ->Unlock to the bases they can visit as
  275.            determined by Sec_Board. A sort of controlled power most
  276.            useful for delegating maintenance.
  277.  
  278.     >= 150 LibOp. Allows the library directory operations R>emove
  279.            on accessible directories. Another semi-powerful maintenance
  280.            delegation feature.
  281.  
  282.     =  255 Sysop. Anyone with 255 Sec_Status can do all sysop functions.
  283.            This includes message base E>xtract, MainMenu E>dit-Accounts,
  284.            and Private Mail $>Read and D>elete. The most powerful online
  285.            capabilities available.
  286.  
  287.         All the other securities are set from 0..255 and are independent of
  288.     status. Therefore a BoardOp can not delete messages from a base which
  289.     is inaccessible because their Sec_Board security won't let them visit.
  290.     One further note, except in the Bulletins, if a section is restricted
  291.     due to security a person will not even see it listed.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.                             FILES ON YOUR DISK 
  300.      
  301.      
  302.     TAG-BBS : The program itself, this is what you run. 
  303.      
  304.     Generate : Utility to generate your system once it is 
  305.                described in the configure files. 
  306.      
  307.     xxx.Help : Example help menus displayed at various times 
  308.                which show available commands and what they do. 
  309.      
  310.     xxx.Text : Files read out for specific events, such as 
  311.                a guest joining the board; these provide information 
  312.                and help customize the look of your board. 
  313.      
  314.  
  315.     Tag.Stat : Created automatically when you first run the program. 
  316.                May be deleted if a new First Day Online is wished,
  317.                perhaps after you are finished with tests and officially
  318.                open your doors for business.
  319.  
  320. *   Tag_User_Log : This is created and maintained by the statistical
  321.                unit of the T.A.G.. Every time a user calls and he signs
  322.                on and off... an entry is placed in this file describing
  323.                the time he signed on, how long he was on and his name.
  324.  
  325. *  Tag_Upload_Log : This file was an afterthought. It is my opinion that
  326.                this file should be unaltered and frequently backed up
  327.                by the SYSOP. This is created and maintained  also by the
  328.                statistical manager totally automatically. It lists all
  329.                files uploaded by ANYONE and includes all the information
  330.                as to what file, from where... when... in case a virus
  331.                or some other malichious crap is uploaded to your board
  332.                and causes problems! You will always know where any file
  333.                originated from on your board!!
  334.  
  335.  
  336.  
  337.  
  338.                      CALCULATING SPACE REQUIRED
  339.  
  340.     When running, TAG occupies both disk space and RAM. This dual
  341. nature is the reason for the speed which surpasses all other Amiga
  342. bulletin board programs and some terminal packages as well. Designing
  343. a system that pushes the limits would be trial and error if I were
  344. negligent and didn't tell you how to calculate the space required
  345. without actually generating the data files.
  346.  
  347. *please note... with TAG-201... these figures are ONLY aproximate! I have
  348. * added MANY new features and many of these structures are affected. If
  349. * you are THAT tight on space... shoot LOW and try it!! The code is
  350. * self-protecting. If it Generates.... it is ok! Please know... there
  351. * is no way that a system designer can know how to reserve space on
  352. * disk based on the UNKNOWN size of your library files. For this...
  353. * you MUST EXPERIMENT!!!
  354.  
  355. Accounts:
  356.     Disk = 386x
  357.      RAM = 0
  358.  
  359. Messages:
  360.     Disk = (136+2500)x
  361.      RAM = 136x + 136
  362.  
  363. Libraries:
  364.     Disk = 216x + File_Sizes (an unknown)
  365.      RAM = 216x + 215
  366.  
  367. Mail:
  368.     Disk = (136+2500)x
  369.      RAM = 136x + 136
  370.  
  371. Bulletins:
  372.     Disk = Text_Sizes (an unknown)
  373.      RAM = 188x
  374.  
  375.     As an example, consider the following small setup-
  376.  
  377. 20 Accounts                    (a very private system)
  378. 1 Message Base @ 20 messages   (full of illiterate people)
  379. 1 Library Directory @ 10 files (who like to download a lot of pictures)
  380. 20 Letters                     (and use mail for text pictures)
  381. 10 Bulletins                   (They need a lot of online help pictures)
  382.  
  383. Accounts:
  384.     Disk = 386 * 20            (7720  bytes)
  385.      RAM = 0                   (0     bytes)
  386. Messages:
  387.     Disk = 2636 * 20           (52720 bytes)
  388.      RAM = (136 * 20) + 136    (2856  bytes)
  389. Libraries:
  390.     Disk = 216 * 10            (2160  bytes)
  391.      RAM = (216 * 10) + 215    (2375  bytes)
  392. Mail:
  393.     Disk = 2636 * 20           (52720 bytes)
  394.      RAM = (136 * 20) + 136    (2856  bytes)
  395. Bulletins:
  396.     Disk = unknown
  397.      RAM = 188 * 10            (1880  bytes)
  398.  
  399. Altogether: 115,310 bytes of disk storage, and 9,949 bytes RAM when running.
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.                 COMMANDS AVAILABLE
  408.  
  409. Awaiting Logon:
  410.   followed by a RETURN--
  411.  
  412.     C       =  Connect to User on modem (You may have gone VOICE to a user)
  413.     A       =  Account editor
  414.     $       =  Sysop immediate logon
  415.     'space' =  Local normal logon
  416.     0       =  Exit to CLI (KILL TAG BBS)
  417.     ?       =  Show Options (a HELP key!)
  418.  
  419. Main Menu:
  420.  
  421.     A>ccount, shows pertinent information (all may use except Guest)
  422.     B>ulletins, text files for reading (governed by Sec_Bulletin)
  423.     C>hat, page sysop to chat (all may use)
  424.     E>dit-Accounts, online editing of users' accounts (255 sysop)
  425.     F>eedback, direct mail to #1 Sysop (all)
  426.     G>oodbye, logoff (all may use)
  427.     I>nfo, system information (all)
  428.     J>oin, become a permanent account, start at New status (only Guest)
  429.     L>ibrary, directories (Sec_Library)
  430.     M>essages, bases (Sec_Board)
  431. *   V> Trivia database access!
  432.     P>rivate-Mail, letters (Sec_Status)
  433.     T>ime, including remaining for user (all)
  434.     ?>Help
  435.  
  436. *   IF you hacve SYSOP access there will be more options under the main
  437. *   menu. As of REV 2.01...
  438. *   E = Edit accounts. This is particularly nice if you want to keep
  439. *       track of your board from a remote location! PROTECT YOUR PASSWORD!
  440. *   S = This gives you the system Statistics package. I have more work to
  441. *       do on this item... but it is functional and pretty straight-forward!
  442. *   X = Shows the 2 log files to you. One log has your USER log with
  443. *       'who was on when for how long' and the other shows you an
  444. *        upload diary of who uploaded what file when! With the advent of
  445. *        this VIRUS business... you know who gave it to you or your user!! 
  446.  
  447.  
  448. Bulletins:
  449.  
  450.     #>number, to read (Sec_Bulletin)
  451.     L>ist, shows all files available with +- security
  452.     Q>uit, go to MainMenu
  453.     ?>Help
  454.  
  455. Libraries:
  456.  
  457.     N>ew, visit all directories with new files
  458.     S>elect, answer Y/N to visit or bypass directories
  459.     A>ll, go through all directories
  460.     L>ist, show directories available
  461.     Q>uit, MainMenu
  462.  
  463.     Prompt:
  464.  
  465. *       C>atalog, show all files numbered with file sizes and 80 character
  466. *         descriptions. The program automatically formats the lines for you
  467. *         to not 'wrap in mid-word'. It should be noted that the NUMBER of
  468. *         the file is ARBITRARY and only valid for that callers visit. This
  469. *         is done because files are DOUBLE SORTED first by NAME and then
  470. *         by Sub-Directory. This has no impact as files can be accessed
  471. *         by NAME (with wild-cards) and the number is only a 'convience'
  472. *         item!
  473.  
  474. *       L>ist/Download .. You must enter the LIST mode to DOWNLOAD. This
  475. *         may seem awkward at first but I added a LOT of POWER to this
  476. *         command and didn'T want to duplicate it in a separate command!
  477.  
  478.         Q>uit, to Libraries above, or next in sequence
  479.         R>emove, delete (Sec_Status >= 150)
  480.         U>pload, if done from keyboard will bypass Xmodem and save
  481.         the file's entry directly
  482. *       The DIRECT upload for the sysop is NOW totally un-necessary! The
  483. *       sysop upload is now TOTALLY automated in the EDIT option below!!
  484.  
  485.  
  486. *    IF you have SYSOP status.... the following entries become evident
  487. *    and available...
  488. *    R = Removal... This option will prompt for a RANGE of files to
  489. *        delete. This option was preserved but it is better to go to List
  490. *        above and find the file with LIST and remove it with THAT menu.
  491. *        The reason I mention this is... <1>You will NEVER want to delete
  492. *        a RANGE of files! <2>as I mentioned...the file NUMBERS will change
  493. *        and you may do damage!
  494. *        Also of note... you are ONLY deleteing the file's description
  495. *        and HEADER information. The file remains! You will have to enter
  496. *        CLI and delete the file from the directory to free the space!
  497. *
  498. *    E = Edit... This will allow a SYSOP status person to EDIT a library
  499. *        header entry to change its description, access priority etc! You
  500. *        will get a mini-menu with LOTS of options including ways of
  501. *        locating a file you want to edit. Experiment a little.. you
  502. *        don't have to work very hard to be a SYSOP!!
  503. *
  504. *    A = This is a SYSOP's dream!! IT has several AUTOMATIC operations.
  505. *        <1> Searches through the library directory for headers to which
  506. *            there is NO accompanying file. This should not happen!
  507. *        <2> Searches through the lib dir for files that have NO HEADERS!
  508. *            As you may see.. all you have to do to load a new file for
  509. *            your users... is copy it to the physical library directory
  510. *            and fire off the AutoEditor!!
  511. *            If you accept the prompt..you will be prompted for which
  512. *            SubDirectory to direct it to, its description and the ACCESS
  513. *            will be automatically set to '2'! (You have VALIDATED it
  514. *            for your users!)
  515. *        <3> Checks for ACCESS > 2. It will list files that are set to 
  516. *            255 (USER uploads) and then prompt you to ask if you want
  517. *            to set ALL of them to '2'... If you say no... you can
  518. *            use the MANUAL editor (E) (above) to selectively set anything
  519. *            you wish!
  520. *
  521. *
  522.  
  523.  
  524. Messages:
  525.  
  526.     N>ew, visit all bases with new messages
  527.     S>elect, answer Y/N to visit or bypass bases individually
  528.     A>ll, go through all bases
  529.     L>ist, show bases available
  530.     Q>uit, MainMenu
  531.  
  532.     Prompt:
  533.  
  534.         D>elete, (Sec_Status >=100)
  535.         I>ndividual, select single numbers
  536.         N>ew, read new messages since last logoff
  537.         Q>uit, to Messages above
  538.         R>ead, select numbered range
  539.         W>rite, edit a message
  540.  
  541.         Between (during reading)
  542.  
  543.             A>gain, go back and read it again
  544.             D>elete, (Sec_Status >=100)
  545.             E>xtract, save into a separate text file (Sec_Status ==255)
  546.             L>ast, go backwards by one and read that message
  547.             N>ext, continue the reading
  548.             P>rivate-Reply, send a letter to the author
  549.             Q>uit, to Prompt above
  550.             R>eply-Regular, write a message in response
  551.             +>Lock, protect from RollOver (Sec_Status >=100)
  552.             ->Unlock, allow to RollOver (Sec_Status >=100)
  553.  
  554. During Chat:
  555.  
  556.     Ctrl-V> Version number
  557.     Ctrl-E Ctrl-E> Edit Online User, must be pressed in quick succession
  558.  
  559. Editor:
  560.  
  561.     During Text Entry
  562.  
  563.         Ctrl-X = Delete the entire current line
  564.         Ctrl-W = Delete the last word entered
  565.         Empty Line = Stop text entry, and start edit options
  566.  
  567.     At Prompt
  568.  
  569.         A>bort and do NOT save the message
  570.         C>ontinue entering more text
  571.         D>elete a line
  572.         E>dit a line already entered
  573.         F>ree space, report how much space is left to use
  574.         H>elp, give detailed help on the editor
  575.         L>ist all text entered so far
  576.         R>etype last line entered to make a quick correction
  577.         S>ave text
  578.  
  579.  
  580.  
  581.  
  582.  
  583.                         FUNCTION KEYS
  584.  
  585.  
  586. F1 = Chat On/Off. Only the local keyboard can enter or leave Chat
  587.  
  588. F2 = Time+10min. Increase temporarily the user's time limit online
  589.  
  590. F3 = Time-10min. Remove 10 minutes temporarily from the user
  591.  
  592. F4 = Force Instant Logoff. Immediately jumps to logoff
  593.  
  594. TAG allows you to control all the I/O streams, which can be a very
  595. useful power. There are input and output options, and all choices
  596. will be displayed in the Status Pane
  597.  
  598. F5 = Keyboard Input on/off. In case you don't want any accidental
  599.      key-presses to affect the online user.
  600.  
  601. F6 = Serial Input on/off. This is the most powerful function, since
  602.      you can instantly make the online user unable to enter input!
  603.      Especially handy for taking them for a walk around the system,
  604.      or in Chat when you want to speak uninterrupted.
  605.  
  606. F7 = File Output on/off. Automatically opens and adds to the end
  607.      of a file called TRANSCRIPT.TEXT which is kept in the directory
  608.      indicated by your configure file, Tag_System LOCAT entry.
  609.      All output will be mirrored into this file until turned off.
  610.  
  611. F8 = Printer Output on/off. Make instant hard-copy through the
  612.      printer, mirrors all output until turned off. Useful for
  613.      recording information during Chat, or for keeping a log of
  614.      some action.
  615.  
  616. F9 = Screen Output on/off. If you don't need to see what's going
  617.      on with the system, you can turn this off. It will freeze
  618.      the local screen, but the Status Pane will continue to monitor
  619.      system activity. Will moderately speed up serial output
  620.      since it doesn't stop to send to the local screen.
  621.  
  622. F10= Serial Output on/off. If you don't want an online user to see
  623.      what you're up to, perhaps editing the account during Chat,
  624.      this is the best. Will not send any output to serial until
  625.      turned on again.
  626.  
  627.  
  628.                        EXPANDED TOPICS
  629.  
  630.  
  631.  
  632.                         MODEM CONTROL
  633.  
  634.         TAG-BBS expects certain things of the modem, the example
  635. setup string provided handles all the requirements, but I have not
  636. made it clear just what is needed.
  637.  
  638.         First, and most important, is that the modem should NOT
  639. automatically answer the phone. This is unlike any other BBS that I
  640. have run across and is a point to be aware of.
  641.  
  642.         The modem MUST send result codes, but should NOT echo command
  643. sequences. You should use VERBOSE results since they send an extra CR-LF
  644. which TAG expects. The EXTENDED result codes must be selected, they
  645. correctly show what speed the caller is using and TAG automatically
  646. handles any speed from 300 up to 9600 in this way.
  647.  
  648.         Disable any "escape code character" to avoid mishaps and false
  649. commands going out to your modem. This is a safety precaution.
  650.  
  651.  
  652.         The suggested OPEN: codes for the following are known and
  653. personally tested.
  654.  
  655. *    PackardBell wanted the folowing....
  656. *                AT E0 M0 Q0 X1 V1 S0=0 S2=255 S7=20 S12=255 &d1
  657. *    before I did this... the examples below would not work! The
  658. *    '&d1' was the KEY change that enabled the hangup sequence
  659. *
  660. *  chuck...
  661.  
  662.      Hayes 1200: ATE0F1M0Q0V1X1S0=0S2=255S7=20S12=255
  663. USRobotics 2400: ATE0F1M0Q0V1X6S0=0S2=255S7=20S12=255
  664.  
  665.  
  666.         The "RESET:" code is NOT the same as the modem Reset command.
  667. Therefore, do NOT use the ATZ command; instead I suggest ATH0 which
  668. ensures the modem is ready for the next caller when it should be.
  669.  
  670.         If anyone has successfully used an AVATEX modem with TAG please
  671. write me a letter containing your modem settings and all TAG MODEM:
  672. control texts. I do not have an Avatex to test on, and people have reported
  673. problems with other BBS programs so I want to fix any problems before
  674. they happen. Or even better, if someone works for Avatex and wishes to
  675. send me an engineering sample I'll make sure that I work out a solution
  676. if the problem exists!
  677.  
  678.  
  679.  
  680.  
  681.  
  682.                     LIBRARY DIRECTORY TECHNIQUES
  683.  
  684.  
  685.         Once an online (by modem) account uploads a file into a library
  686. it is immediately available for others to download, all governed by
  687. the securities you've set, of course. Ordinarily this makes things very
  688. easy on a sysop since there is no maintenance involved. However, people
  689. cannot be trusted sometimes and might upload files you do not want.
  690. If you are worried about problems like this I have a solution:
  691.  
  692. Give one directory a very high Download security (255,255) so that only
  693. someone with that very high Sec_Library can access it.
  694. Set the Upload security to what you want, I'd suggest 0,255 so that
  695. even a guest account may send in a file.
  696. Then you must copy the file itself into a regular directory and do a
  697. "local upload" to make it available to everyone else.
  698.  
  699.  
  700.  
  701.                       MESSAGE BASE TECHNIQUES
  702.  
  703.         "One Liners": since old messages will automatically roll over
  704. once a base is full to make room for new, you can exploit this fact and
  705. create a base where there is only one message. All anyone can read and
  706. respond to will be the very last.
  707.  
  708.         If you +>Lock that single message so it doesn't roll over you
  709. have made a bulletin inside the message base that will show up when
  710. an account does a N>ew read of all bases.
  711.  
  712.  
  713.  
  714.  
  715.                      GENERATE AND HOW TO USE IT
  716.  
  717.         TAG-BBS needs many disparate files to store data and keep
  718. track of the data stored. Since each system has different sizes I can't
  719. give you already existing files, so I give you Generate. Once you have
  720. set up all your configuration you run Generate. The display shows its
  721. progress and any problems that might arise. Generate will not re-create
  722. any data files that already exist.
  723.  
  724.         Since Generate does not re-create existing files you may add
  725. new bases and directories as often as you like, running Generate after
  726. each change to the configure files. You do not need to run Generate if
  727. you are just making changes to s:Tag_Bulletins.
  728.  
  729.         Note that any errors creating a file will cause the generic
  730. "Previous KEYS exist" message to appear; if you know that a file
  731. should have been created this is a signal : you you should check
  732. for errors and correct them.
  733.  
  734.         THIS EXAMPLE should only be read by those confident with
  735. AmigaDOS and CLI commands. In order to increase the size of an already
  736. existing directory or base without destroying all previously existing
  737. data you must do as the following example for messages shows:
  738.  
  739. Change the number in s:Tag_Boards to be the difference between the
  740. old number of messages and the new. If you HAVE 100 messages and WANT
  741. to have 150, the number is 50.
  742.  
  743.    change the s:Tag_Boards temporarily by using the above example to 50
  744.    cd board-directory
  745.    rename Board.Data Old.Data
  746.    rename Board.Keys Old.Keys
  747.    Generate (and if everything goes well continue, else fix the problem)
  748.    rename Board.Data New.Data
  749.    rename Board.Keys New.Keys
  750.    join Old.Data New.Data AS Board.Data
  751.    join Old.Keys New.Keys AS Board.Keys
  752.    change the s:Tag_Boards to the full number you wanted, ie 150 here
  753.  
  754. I told you it was complicated..
  755.  
  756.  
  757.  
  758.                          TIME LIMITS
  759.  
  760.         There are three important pieces of information kept with each
  761. account on the system: Time_Last_On, Time_Limit, and Time_Used.
  762. Time_Last_On is something you cannot normally change, it is what keeps
  763. N>ew readings in order. Limit and Used are the two we are concerned with.
  764. Each time a person calls, Time_Last_On is checked and if it is over 12 hrs
  765. ago they get the their full Time_Limit and Time_Used is set back to 0.
  766. If not, then the time they've already used is subtracted from their limit
  767. and if there is any time left they get to the Main Menu. If all their time
  768. has been used they are sent the Logon24hrs.Text and disconnected. This
  769. 12 hour limit is based on the time they last called, NOT the calendar day.
  770.  
  771.  
  772.  
  773.  
  774.                        FUNCTION KEY HINTS
  775.  
  776.         Though I have previously described the use of the function keys
  777. it often helps to show them in actual use. Running AmigaBoard we've
  778. come across some interesting side-effects and techniques:
  779.  
  780.         To generate a report of all library files available, turn on
  781. the Transcript.Text file (F7) and visit each library in turn doing a
  782. complete L>ist, or C>atalog for quick summaries. You may also send this
  783. directly to printer using the (F8) function key so you get both a text
  784. and "hard copy" version without having to print it later.
  785.  
  786.         The same technique can be used to generate a report of all
  787. active accounts by using the U>ser_Listings command.
  788.  
  789.         While not actively watching the board it helps to turn off
  790. the screen output (F9). You'll still get Status Pane reports, but the
  791. main display will be frozen; this will speed online activities by a
  792. small degree.
  793.  
  794.  
  795.  
  796.  
  797.                   CREATING A "CLOSED" SYSTEM
  798.  
  799.         For those of you who wish an exclusive bulletin board, where
  800. members can not Join but must be entered manually by the sysop for
  801. security reasons, here is a technique:
  802.  
  803.         In the Tag_System file, edit the GUEST entries to have a
  804. time limit of 0. When someone who does NOT have an account calls in
  805. and tries to enter as a Guest they will instantly be read the file
  806. "Logon24Hrs.Text" and the connection terminated. You may edit the
  807. file to contain a No-Admittance message instead of an overtime message
  808. to get the point across. Any members who exceed their limits will also
  809. be read this text, so you should tell them about it before that happens.
  810.  
  811.  
  812. ************************************************************************
  813. The following is ALL from CHUCK and the FUTURE is BRIGHT!!! I am sorry
  814. if this documentation is not all up to date. I am in a rush to get this
  815. package out as a true PLATEAU is here and as is normal; documentation
  816. always lags a product. If you are a T.A.G. user now... It should be
  817. apparrent... This represents a MAJOR upgrade with much, much, MUCH more to
  818. come!!!
  819.  
  820.  
  821.                     THE TRIVIA SUBSYSTEM
  822.    This little diversion is still under construction but it is functional
  823. at its present state. There are only 4 keys in the trivia subsystem..
  824.  
  825. User: A=answer a question  S=Look at the hall of fame
  826. SYSOP: I=import a trivia file to the board  E=Edit a trivia question
  827.  
  828.    There is not much to say about this part of C.A.B. except that all
  829. questions are editable in the import file as well as in the live system
  830. file. The import file is made up of sets of 5 line records. The first
  831. is the question (max 80 chars), the next 4 are potential answers with
  832. the CORRECT choice having an ASTERIK in the FIRST column!!
  833.    The import file must be put in the S: directory and named 'TRIVIA-IN'.
  834. It is sudgested that you keep this source file and edit it to add more
  835. questions. The TAG_System file has a Trivia parameter to set the MAXIMUM
  836. number of questions. This only affects DISK space.. not memory!
  837.    The only thing that seems to go wrong with this is the data length
  838. is too long of either the question or answers. Remember.. Questions=80
  839. and answers=40 characters MAXIMUM!! If any one is beyond that you will see
  840. questions and answers mixed in weird disarray!!
  841.    As I mentioned... this is still CRUDE! Much more is planned and patience
  842. is the keyword!!
  843. ---------------------------------------------------------------------------
  844.                         S  O  U  N  D
  845.     There is a sound file called tag-sound. It is an IFF soundfile. I put a
  846. sound-player into T.A.G. to play any sound file you substitute for this
  847. file. The sound is played to the SYSOP when 'PAGE THE SYSOP' is hit by
  848. a user. You may substitute whatever you wish for this file but it must be
  849. named 'tag-sound' and must be in the same directory as 'tag' the
  850. executable!!
  851. -------------------------------------------------------------------------
  852.  
  853.    All comments, suggestions, critisism is WELCOMED!!! I don't have much EGO
  854. and I do want to help! I originally patterned this for my OWN use but
  855. I want to make it useable for as many as possible. If you experience
  856. problems with this version of T.A.G. .... take the time to let me know...
  857. please ... EVERYONE will benefit!!
  858.  
  859.  
  860. Keep in mind... what you see as a USER is only a FRACTION of what there is
  861. to the T.A.G. that this has become. The real power of T.A.G. is in the SYSOP
  862. interfaces provided!
  863.  
  864.     In upcomming versions will be....
  865. Multiple protocols...
  866. Smaller executable....
  867. PLUS.... Whatever YOU can suggest that I can impliment!!!!
  868.  
  869.  
  870. Remember... for the best and latest in home grown software .....
  871. Chucks C.A.B. BBS .... 302-764-3186 !!
  872.  
  873. When you call the BBS... BE ABSOLUTELY SURE TO IDENTIFY YOURSELF
  874. as a T.A.G. USER!!! And what Rev you are running on!!
  875.  
  876.              ====    END of REV 2.01   ====
  877.  
  878.  
  879.  
  880.                        TAG BBS rev 2.02
  881.  
  882.     Sorry users... Some holes surfaces the other day while tinkering
  883. around with the SYSOP interface. This upgrade is ONLY the TAG executable.
  884. All you must do to use the upgrade is install the file 'tag' in place
  885. of the copy you are now useing!
  886.     Also, a last minute bug surfaced in the Library generate utility. Use
  887. this new generate utility if you generate a new or upgrade system. If your
  888. system is already set-up to your liking... no new generate is necessary.
  889.     You may not have noticed the problems as they were small but they are
  890. FIXED in this module.
  891.  
  892.                        TAG BBS rev 2.03
  893.  
  894.    Several users contacted me and expressed a wish to have a T.A.G. BBS
  895. operate with no Library functions as they didn't have a hard drive
  896. or even a second floppy. I think I made the necessary changes to the
  897. Generate utility and the TAG system itself to make it work with the
  898. NLIBS: parameter set to '0'!!! Try it and let me know what you think!!
  899.  
  900.                     *********************
  901.                     *  TAG BBS rev 2.04 *
  902.                     *********************
  903.  
  904.     The LIBRARY has been changed and new features added. This upgrade
  905. will NOT affect the present files or thier descriptions (if you already
  906. have a BBS operating).
  907.     The change is evident and is described in the Tag_Libraries as well
  908. as being presented here. After you set up the Tag_Libraries file as
  909. presented... you can delete the comments in these files!!
  910.  
  911.  
  912.    A protection mode is provided at the sub-lib level to keep certain eyes
  913. out of certain files. If this mode is used... a sub-lib's contents
  914. (in all libraries of your bbs) will not appear to a user with less than a
  915. '3' access level.
  916.     You may note that a new security level is now available for GENERAL
  917. use in security. But when specifying "sub-lib" security.. it has very
  918. special applications.
  919.     The new parameter is 'SUBPROT:'  and the mechanism works like this...
  920. You enter the sub-lib's number that appears in the sub-lib list after the
  921. SUBPROT: and that sub-lib will be protected from access by any user with
  922. a security level LESS THAN 3!! But... MORE than that... they will not
  923. even be able to see what data is in them. List and Catalog will not
  924. list thier contents unless the user is a level 3!!
  925.     So understand... you could turn off the SUBPROT: and set the security
  926. on an entire library to '3'!  The user wont be able to upload/download
  927. in this area either... but he CAN read the descriptions!! See the
  928. difference???
  929.    If you wish to not use this security avenue, simply set this parameter
  930. to a number higher than the highest sub-lib in existance on your
  931. board ('SUBPROT:9999' is a good choice)!
  932.  
  933.    Please note: the NUMBER of the file you put in this parameter matches
  934. the position in the list of sub-libs in the Tag_Libraries file and it
  935. is not the actual sub-dir number that appears when the board is up and
  936. running. This is because the FIRST sub-lib is 'ALL' and must be 'ALL'
  937. for the library program to work!...and causes this  parameter named
  938. to be offset by one!
  939.  
  940.                      ******************
  941.                      *    TAG 2.08    *
  942.                      ******************
  943.  
  944. LOTS AND LOTS OF STUFF was added !!!  Read on McDuff.... Many of the new-
  945. found users comments (as promised above) have been brought to this level.
  946.  
  947. 1. TAG has been put on its own SCREEN. But it is a 1-bit screen!
  948.     <A> It uses only HALF as much memory as before.
  949.     <B> If you have the memory... it helps the BBS to multi-task with
  950.         other things you, as SYSOP, may want to do with your machine
  951.         while the board is running!
  952.     <C> Allows you to push the screen and its windows to the bottom
  953.         or, using the BACK gadget, pop the BBS system completely
  954.         BEHIND the workbench screen. You can actually FORGET its
  955.         running there!! 
  956.  
  957. 2. A 'Logoff.text' file is provided for and must be edited into the
  958.    system enviornment. This will be broadcast at the time of a normal
  959.    logoff of your user.
  960.  
  961. 3. Private mail has a number of changes.
  962.    <A> You can now pause the display when listing a letter you are editing.
  963.        The only key valid (at this rev) is the space bar. The letter will
  964.        pause on its own at 20 lines... and hitting any key will allow it to
  965.        go on.
  966.    <B> In the editor.. an extra prompt has been provided and a 'CHANGE
  967.        STRING' option is added. If you choose <C>hange.. the line to edit
  968.        will be listed.. and you are prompted for 'string to change' and
  969.        if its found in the line... prompted for 'string to change it TO'!
  970.        MORE POWER TO THE PEOPLE!!
  971.    <C> EXPRESS MAIL is now implimented in all facets of mail.
  972.          <1> All mail to SYSOP is automatically given EXPRESS mail
  973.              status.
  974.          <2> Express mail is handled exactly the same as normal E-mail
  975.              except...  when a user (who HAS express mail E-mail) signs on...
  976.              he is presented with the E-mail immediatly. If he chooses not to
  977.              delete it... it becomes just simple E-mail upon subsequent calls
  978.              to your board.
  979.  
  980. 4. A new item was added to the Main Menu. The <N>ew point setting!! This
  981.    will affect all menus NEW option. You are presented with your
  982.    present setting... which is normally the LAST time you were on the
  983.    BBS and logged off... and you may advance/retard this point by any
  984.    number of HOURS.
  985.  
  986. 5. Many new stats items have been added/modified for the convenience
  987.    and support of the sysop. Most of these are apparent to the SYSOP
  988.    and won't be individually listed.
  989.       <A> The one major change is in the SYSOP menu under Library
  990.           support. Under the library menu.. there is now only <M>ain-
  991.           tenance. This, if invoked, brings up another menu.
  992.               <E>dit.. this allows editing of library entries which are
  993.                        selected in a number of ways with its own sub-menu.
  994.                        Simple experimentation will make these
  995.                        aparrent to you.
  996.               <A>uto-Edit.. This is described earlier in the documentation
  997.                        and is what you should run if you copy many new files
  998.                        into the library for your users. It makes SIMPLE the
  999.                        work of adding many files to the user library.
  1000.               <V>alidate.. is what you will probably run MOST often.
  1001.                        This function searches the headers and displays files
  1002.                        your users have uploaded. It displays them and
  1003.                        their information for you to validate for the
  1004.                        rest of your users (give it an ACCESS value [2 or3]).
  1005.  
  1006. 6. The title bars of BOTH the screen and the windows are used for information
  1007.    display. If a user is on and requests a CHAT and you were out-of-the
  1008.    room and missed the call bell... for the remaining time of his call..
  1009.    The title bars of all the windows will show the *** CHAT REQUESTED ***
  1010.    status. Once you answer the chat or he hangs up... the display will go
  1011.    away.
  1012.    During normal communication.. the windows' bars will show the caller's
  1013.    stats. Make use of this however you see fit. It helps me know if he's
  1014.    calling long distance of if they are an assett or an ass while I am
  1015.    monitoring the board operation. The display will toggle every few
  1016.    seconds setting new information!!
  1017.  
  1018.               =========== END of REV 2.08 ===========
  1019.  
  1020. REV 2.09
  1021.     A minor oversight was fixed. Reply to mail now supports the EXPRESS MAIL
  1022. option and SYSOP forced EXPRESS MAIL (if ExpressMAil is allowed via the
  1023. Tag-System parameter)
  1024.  
  1025.               =========== END of REV 2.09 ===========
  1026.  
  1027. REV 2.10
  1028.    The Tag_System file is expanded to include configurable HOT-KEYS for
  1029. when you are in CHAT mode. The earlier TAGs had these glib phrases locked
  1030. from your manipulation except with a good sector editor. So now...
  1031. you enter a number of keys encoded in a parameter called CHATCOM: and
  1032. after this.. enter the key # (a=1... z=26) in following data lines
  1033. and the associated data to be put out when these keys (along with CONTROL
  1034. key) are pressed!
  1035.  
  1036.  
  1037.  
  1038.               =============== END OF REV 2.10 ================
  1039.  
  1040. Thoughts for the  future...
  1041.         AND I mean the NEAR future.....
  1042.                          MAYBE tomorrow.....
  1043.  
  1044. WX-modem... Y-modem.... Z-modem... Off disk libraries (request files)....
  1045. Voting booth.... Change password.... Comprehensive (possibly graphic)
  1046. statistic package.....
  1047.  
  1048.  Problems... Questions... Sugestions...
  1049.  
  1050.           Call my board
  1051.  
  1052.           Chucks C.A.B. of Delaware
  1053.           302-764-3186
  1054.           302-764-6079 (voice)
  1055.  
  1056.  
  1057.